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BugJixeS 

Here's another article in the continuing T)ug fix' saga. This 
first one fixes Kevin Darling's RAMMER to work properly, 
and corrects a previously unknown bug in PRINTER. 

rHmmEr 

I'm sure everyone has heard of problems with RAMMER 
working with 2-meg systems. The cause of this is a section of 
code which goes: LDB >$FFAO [...] STB >$FFAO. This 
saves/restores a block in the system map. 

As Kevin Darling, himself should know, the MMU 
registers are not really readable. They are (sort of) on a 512k 
system, but definitely not on a 1 or 2-meg system. The 
solution is simple, just change the STB to a CLR Since the 
system alwaj's has block mapped into $FFAO, there's no 
need for saving a copy of the NOvlU register. If Kevin had 
wanted to be "legal" rather than "semi-legal", he would have 
used the system DAT map. (BAD Kevin!) 

offset old new 

$00D4 SF7$7F 



If you have a 2-meg system, and want to use RAMMER to 
'mimic' an external drive, use the patches below to 
change the maximum number of blocks that it will use. 

offset old new 

SOOOC $68$36+NB 

$0074 $32 NB 




Putting OS-9 in ROM is fairly simple. 

Basically, there are two changes that need to be made. The 
first change fixes a bug in the REL module. That change 
can be made by simply running modpatch with the included 
script ('rel.pat.') Before you make the change, though, type 
"ident -m rel" at the shell prompt. The output should look 
like this: 

Header for: REL 

Module size: $012A #298 

Module CRC: $6FD34C (good) 

Header parity: $D3 

Edition: $05 #5 

Ty/La At/Rv: SCI $81 

System mod, 6809 obj, re-en, R/O 
If the output doesn't match this, DON'T TRY TO PATCH 
RED. Boot-up with another disk (you'll have to reset 
twice to start from RS-DOS again), and try ident again. If all 
else fails, boot-up with your backup of the original OS-9 
system disk. That definitely should match. Once you have 
patched REL, cobbler to a new disk, 

ROM BOOT Continued on Page 3 



where NB is the number of blocks (rounded up) required 
to mimic an external drive, i.e. for a 80-track double 
sided disk, NB=(80*2*18)/32=90 ($5 A) blocks. 



PrINiEr 



This is a little-known, and mostly useless bug fix. The 
problem can be seen by doing a "list /p". Since the 
printer is a write-only device, attempting to read from it 
should produce a 'bad mode' error. Instead, I get Error 
#056 - (basic09 error code). The cause of this is simply 
that someone left a '#' off a LDB #E$BMode, and the 
error you see is whatever is at <E$BMode in the system 
DP page. 
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offset old new 
$0170 $D6$C6 

This modification should solve the problem in a satisfactory manner. The reason 
no-one has seen this before is that no one was dumb enough to try reading from the 
printer (What does that say about me, eh? >) 

Here is a patch for fixing a bug in Kevin Darling's "*Xmas grfdrv" (FSTGRF,AR). 
The problem here can be seen by using VIEW to look at a series of GIF piaures. 
Count the number of times you can view a picture before getting an error, and add 
in the number of windows you already have open. They should add up to 32. 

What's happening is that grfdrv is saving a wrong flag, and CC3I0 can't match 
it. So rather than having a maximum of 32 windows at one time , you're limittted to 
32 windows totally in one session . This bug is NOT in the stock grfdrv, but was 
introduced by Kevin in his enhancements. Luckily, it's easy to fix, just patch one 
byte: 

offset old new 

$03D0 SFE SFF 

Re-verify and save out to your CMDS directory. This fix has made the difference 
between forced reboots every time I couldn't open a new window, and having my 
CoCo running continually for longer periods of time. 



CLOCK 



IF you have installed a higher frequency crystal in your CoCo to optain faster 
clock speed then you have noticed that your time display is no longer accurate. 
Here's the solution: 

Using dEd, look in the Clock module for a byte sequence $86 $3C $97 $2E, This 
sets up the number of 'ticks' per seconds. With faster crystals, there are more ticks, 
so the $3C must be changed according to the following formula: 
NEW = 60 * (crystal speed [MHz])/(28.63636) 

So for a 41 MHz clock, *NEW'-85.9, or rounded up, 86 ($56). Simply replace the 
$3C above with $56, 

==Alan DeKok=- 
FidoNET;OS-9 Echo 




iBHELL 



This patch changes the defauH number of pages for processes forked from SHELL. 
Any process forked HAS to have at least one page, but many do not need as many as 
the original value was/is set for. It was set so high because any process forked ends 
up with an entire 8K for its data space. $1F pages is almost one whole block (8K), 
Offset Old New 



$130F $1F 
$1313 $1F 



$01 
$01 



=Wes Gale;KZIN BBS= 
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Now, reset twice to return to RS-DOS and type in the following program: 

10 CLEAR 500,&H3FFF 

20 INPUT ^'INSERT OS-9 DISKETTE IN DRIVE AND PRESS <ENTER>" ;A$ 
30 FOR A = 1 TO 18 
40 DSKI$ , 34 , A , A$ , B$ 

50 FORM = 1 TO 128: POKE &H3BFF+A*256+M,ASC(MID$ (A$ ,M,1) ) 
60 POKE 6H3F7F+A*25€+M,ASC(MID$(B$,M,1)) 
70 NEXT M , A 

80 POKE &H4 000, 68: POKE &H4001,75 

90 INPUT " INSERT RS-DOS DISKETTE INTO DRIVE AND PRESS <ENTER>" ; A$ 
100 SAVEM "OS9BOOT/BIN",6H4000,6H51FF,fiH4002 

Double check your typing, and then run the program. When done you will have an ML file on 
your diskette that can be loaded and burned onto an EPROM. In case you couldn't figure it out 
from the listing, the code resides in memory locations $4000 to $5 IFF (or &H4000 to &H51FF in 
BASIC.) 

With the resulting EPROM installed in your disk controller, OS-9 will automatically boot from drive 0. If you want to 
boot directly from your hard drive, you will have to replace the floppy BOOT module with one that will read from yom* hard 
drive. 

==Mike Sweet== 
^^^^^^^^^^^^^^^^^^^^Delphi^^SigDat^^ 

Function Calls in C 

C Tutorial by Randy Kirschenmann 

else 





RELpat 


Irel 


c OOdd 30 33 


c OOeO fc 19 


c OOel 8c 11 


c OOel cd 83 


c 00e3 00 ed 


c 00e4 24 00 


c OOeS lb 24 


c 00e6 ce la 


c 00e7 26 12 


c OOeS 00 12 


V 



WeVe had a look at how data is defined in a C program and 
now well see how that data can be acted on. The fimction call 
is the equivalent to Basic09*s PROCEDURE statement, but 
since there are relatively few executable commands in C, 
you'll find many more fimction calls in C than in Basic09, In 
fact, the standard C library is a collection of Amotions, 
compiled into executable code and merged together as a 
library of fiinctions. A fimction hides the mechanics of data 
manipulation in a "black box" and gives the programmer a 
chance to forget about how things are done, instead allowing 
us to concentrate on what is being done. Showing several 
examples will be the best way of describing this mechanism. 

Let's start with a simple problem; how can we display the 
bit pattern of data items in a program? Looking at the 
standard C library we see printfQ^ puicharQf putcQ and a few 
related fimctions available. However, trying all of these will 
show you that none will display the individual bits inside of a 
char or int data item. So it looks like we need to develop our 
own routine to do this. To test whether a bit is on or off we 
can use the bitwise AND instruction. We can build a mask of 
each bit position and AND this mask byte with the data item. 
Then we would check the result of this operation to determine 
if the tested bit were on or ofif. The code would look 
something like: 

unsigned mask; 

unsigned test_data; 

mask = 0x8000; 

if(test_data & mask) 
putcharCr); 



putcharCO'); 

This piece of code will only test the high order bit of an 
integer data item, when the bit is on the if statement will be 
true and a *1' will be displayed. If the bit is ofif a '0' is 
displayed. Remember that when we AND a bit position that is 
set on (T) with another '1' bit the result is a T bit, non-zero, 
or true, but when we AND a '0' bit with a '1' bit the result is a 
'0', or false. Also when we AND the T or '0' bit with a '0' bit 
the result is a '0\ which is interpreted as false in the C 
language. Thus, our conditional statement is true only when 
the high order bit is on in test data. In order to test the rest of 
the bit positions we write a loop such as: 
mask = 0x8000; 
while(mask) { 

if (test^data & mask) 

putcharCl'); 
else 

putcharCO'); 
mask »= 1; 
} 

The expression "mask »= 1;" looks a bit strange at first. 
Remember that this is equivalent to the more easily read 
statement: 

mask = mask » 1; 
which assigns a new value to mask obtained by shifting the 
bits to the right one position. This will take 0x8000 and give 
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us 0x4000, then 0x2000, etc. until we get ( 0x0001 » 
) which results in zero. This will end our loop since 
while(mask) is true only when the value of mask is non-zero. 

This bit of code will display a string of eight I's and O's 
for the unsigned integer value stored in testdata. To make 
the display a bit more readable we can add some formatting, 
such as: 

int i = 0; 

if(!(-H-i % 4)) 

putcharO '); 

if(!(i % 8) 

putchar(* '); 
this snippet should follow the //- else block. This code also 
looks strange at first. The expression (mask % 4) gives us the 
remainder of mask divided by 4. There are 16 bits in an int 
data item when compiled on the Coco 3, using Microware's C 
compiler. Of course, this remainder will be zero when the bit 
count is 4, 8, 12 or 16. When we code if (! (expression)) we 
are asking for true when (expression) is zero. Therefore 
if(l(mask % 4)) is true when our bit count is 4, 8, 12 or 16; and 
ifO(mask % 8)) is true when the bit count is 8 or 16. This 
causes our display to have the format: xxxx xxxx xxxx xxxx. 
The complete function would be written as: 

#include <stdio.h> /* needed for putcharQ */ 

printbits(test_data) 

unsigned test_data; 

{ 

int i=0; 

unsigned mask = 0x8000; 

while(ma$k) { 

if(test_data & mask) 

putchar('l'); 
else 

putchar('O'); 
if(!(-K-i % 4)) 
putchar(* '); 
if(!(i % 8)) 

putchar(* '); 
mask »= 1; 

} 

} 

Here we have the complete function, named printbits. This 
code can reside in a separate source file, or can be coded 
directly into the primary source file of a program. To test this 
function we could write: 
#include <stdio.h) 
mainQ { 
intc; 

for(c = 0; c < 256; C++) { 
printb!ts(c); 
putchar('\n'); 
} 
} 
If you code this and place the code for printbitsO following the 
closing } you can compile and run this to show how printbitsQ 
will look on your screen. 



The heart of the demonstration is the call to printbitsQ ^ This 
function takes an unsigned int data item as its argument. 
What we have defined in mainO is a signed int data item. C 
will convert this data to an imsigned int when the call is made. 
It should be noted that the fimction we have created here will 
return an undefined integer value. This is C's default return 
type. To utilize a function's return value you must code a 
return statement as in: 

fO{ 

/* some statements */ 



} 



retum(value); 



and then in the call to the function you assign this value to a 
variable or test its value as in: 
int i; 



i = fO; 

/* more... */ 
Returning to our printbits() example, try changing the for 
statement to: 

for(c = -1; c < 0; c~) 
running this takes longer so unless you want to see eveiy 
possible negative value that can be represented by an int data 
type, go get yourself a cup of coffee (and a sandwich). But 
notice where the display ends. This shows us how two's 
complement data is represented by our Cocos. Oh, and don't 
forget to tmode -pause before running this! 

What we have seen in this example is that once the 
function is developed and tested we can sort of put it out of our 
minds forever. We no longer have to think about what is 
going on internally to produce our display of bits all we need 
to do is call printbitsO to see what our data item looks like in 
binary. We still need the source code to printbits to 
accomplish this, however. I've moved the source into a 
separate file, called yZ)//5.c and compiled this vwth the mainQ 
function residing in another file, called test.c using the cmd 
line: 

cc2 teste fbits.c 
and then miming the test by typing: "test" at the 0S9: prompt. 
Useful functions can find their place in many programs. 
When you finally develop that special routine that you find 
yourself using over and over again, you can move it into a 
library from where it can be called directly by the linker 
without the need of recompiling. This is done by compiling 
with the -r switch as in: 

cc2 -r fbits.c 
and then merging the output of this compile into a library by 
typing: 

merge fbits.r my lib > mynewiib 
Be aware, though, that the C compiler we are using utilizes a 
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forward referencing linker. What this implies is that new 
routines being added into a library which make calls to other 
functions in the same library must be placed ahead of the older 
functions. That is to say if we were to place printbitsQ into the 
standard C library (clib.l) we need to code the merge statement 
as: 

merge fbits,r clibJ > newlib 
and not; 

merge clib.I fbit$.r > newlib 
which would place printbitsO at the end of clib.I. In the second 
case when printbitsO attempts to call putcharQ it would fail to 
locate the function /?wrc(? which resides in clib.I. 

There are a few special fimctions I've coded in the course 
of my work on the Coco, that I have considered important 
enough to the programs I play with, that I have merged them 
into clib.L Usually I wouldn't reccomend altering the standard 
C library and instead build a new one for your developing 
collection of useful routines. To signal the compiler that you 
want additional libraries to be scanned at link time use the -I 
switch such as: 

cc2 teste -l=<path>/mylib 

This short article is hardly adequate to the task of 

explaining what function calls mean to the C language, but in 

future articles we will be returning to this subject. In time the 

broader picture of progranuning in the C language will begin to 

emerge. 

=Randy Kirschenmann= 

Mt. Rainier CoCo Club 

FidoNET;OS-9 Echo 
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J Great Stuff ^ 



I for your OS-9 System | 

• We've been in the software business for over 1 1 ^ 
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iJUpdate Report 

by Chris Burke 



A number of people have asked recently about the status of 
The Rocket, For those not familiar with this topic, The 
Rocket is a circuit board with 68306 CPU, 2 SIMM sockets, 
a bus synchronizer, 32K byte on-board ROM, 6X09 CPU 
socket, mode switch, and alimited (no bus) I/O expansion 
counnecto. It plugs into the CoCo 3 CPU socket. The CPU 
runs at 14 MHz (16.7 MHz with fast memory). The on- 
board SIMM sockets allow 512K, 2MB, or 8MB of on-board 
memory. 

Beginning in May, Burke & Burke offered to sell The Rocket 
at $195, including 0S9 disk and boot ROM, but no memory; 
2MB of memory was offered for an additional $100. Both 
offers were valid only if 100 orders were received by 3 1 July, 
1993. It is now nearly the end of August, and fewer than 100 
orders were received. 

Since May, the per-imit cost of the Microware 0S9 
modules has essentially quadruppled over initial estimates; a 
license originally listing at $50 per unit now lists at roughly 
$170 per unit (for a run of 100 units). Burke & Burke was 
able to negotiate an arrangement which only doubles, rather 
than quadrupples, license costs for The Rocket, but the 
arrangement changes the fundamental cost structure of The 
Rocket in two ways: 50% more software development 
required from Burke & Burke, and higher per-unit costs. 
Another blow: a recent semiconductor factory fire in Japan is 
driving up the price of SIMM memory, to the point where 
$100 for 2MB wiU soon be below cost. While Burke & 
Burke could return everybody's downpayments and cancel 
orders, I really believe in The Rocket and would like to see 
the project completed, 

Burke & Burke is open to suggestions from the 
community. Here are a few that have already been made: 

1) Raise the zero-K price (say, from $195 to $249) and 
discontinue the 2MB model If only 15% of the existing 
orders cancel, there will still be enough orders to go into 
production and ship by Christmas. 

2) Cancel the project, return everybody's downpayments, and 
release the design to either the public domain or another 
vendor. 

3) Offer The Rocket, but only with 512K memory and no 
0S9 software (say, for $149). The design would be 
modified to allow the 6X09 to use the 68306 as an 
I/O coprocessor, and would include a light weight realtime 
kernel for the 68306, software to download code from the 
6X09 to the 68306, and inter-CPU communication routines. 

I hope that this status report answers your questions 
about current status of The Rocket. If you reply to this post, 
please use private email on internet to this address: 

Chris Burke <burke@mdd.comm.mot.com> 
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Public Domain Library 




AppUcatiopi PufrUc Pomidn Di»k 



AR 

JERRYBENCH 

SIEVE 

SAVAGE 

PILOT 

FILER 

ADRLABEL 

SPEEDISK 

INVENTORY 

EXAM 

Catalog 

Clyde_ v2 



Archive/UnAichive file Utilily 

10x10 matrix multiply benchmark 

Self-timeir^ benchmark 

Bench mark 

Pilot language processor 

Miscellaneous Scratch Pad and DataBase 

Simple Address Label Maker program in Basic09 

Floppy disk compression/repak ulility 

Home inventory program 

Basic09 Multiple Choice Quiz Program 

Catalogs disk files for easy reference 

Aniiimated graphics for use as a screen saver 



Graphics Public Domatn Disk 



GROUP 1-20 

GROUPTXT 

VEFPRT 

VIEW 

MANDEL 

COCD31BM 

V1EWG1F2 

V1EWVEF2 

A1F_MGR 

SUPERIKE 

PSHELL 

PUBFONTS 



Chp Alt graphic files for Tandy's Home Publisher 

Documentation file for Group I -20 clip-art files 

VEF graphic format print-out program 

VEF, MGE, CM3, 64D format viewer utility with window 

Mandelbrot Graphic generator (Basic09) 

4 VEF files re: mounting CoCo-3 into IBM type case 

GIF format viewer with color "flickering" 

Displays "fficker" VEF files as well as normal VEF 

Basic09 utility to create AlF files for Multivue 

Icon editor Mouse control & dr^ palette colors 

Mouse controlled Graphics User Interface for those 

who dont like Multivue 

Fonts for Tandy's Home Publisher 



Graphics Public Pomain Disk 2 



CLICKl 

ICON EDIT 

PAK 

PRTPIX 

ICONS 

PlXLO/vDER 

OTHEL 

PDC 

FLTBRG 

MGEPIX 

GIF0S9 

PGCHARTS 

VEFNUDES 

WATERFALL 

SHUTTLE 

BrreucKET 

BALLS 
MAXPIX 
OLIVER 
GOOFY 



Gr^hics dock time display 

Creates icon gr^hics for Multivue 

File management Archive utility. Pak/unPak into/fi*om 

Prints DESICMATE pictures to Gemini NX-IO printer 

Library of Multivue AIF and Icon files. 

Laods and di^days VEF foimat graphic files 

Packed basic09 othello game ' 

VEF pix viewer. Atari ST>VEF converter and docs file 

VEF pbc fi^om Flight. Simulator II 

View MGE format pics like VEF ffles 

View GIF format, pictures 

VEF pix of charts 

3 VEF pix of nudes 

VEF pix of a waterfel 1 

VEF pix of NASA Space ShutUe 

VEF pix of bits running around circuit board 

VEF pix of Universal Balls 

VEF pix of CoCo Max screen 

MGE pix of Bloom County's Oliver viewing compuler 

MGE pix of Walt Disney's Goofy 



Graphics PubUc Dooialn Disk 3 

Pubfonts : More Home Publisher fonts converted fi^om "Giaphicom- 

Part lir. Basic font converter mcluded in package. 
Screen ; 3 soeen savers "motion", "circle", "lines" 

DJ500BW : Graphics screen dump to a Hewfet Packard Ink Jet Printer 

ANSIFONT : Ansi fonts data file. Used like Stdfonts in graphic windows. 

DEFINITIONS : Description of commonly used graphic picture formats used 
on OS-9 (CoCo), i.e., GIF, VEF, CM3, CLP 

MisceUancous Public Domain Disk: 

WIND : Basic09 program thai pronipts for window parameters 

FUNDOW : Basic09 windows demonstration program 

CLOCK ; Basic09 script file t.o init.ialize a clock/dat.c 

FUNOV : Basic09 window overlay demonstrationAitilit55 program 

WINDOWS ; 7 window script files for use with above programs. 

INTFIX : IRQ fix required when using the RS-232 PAK. Hack is 

done to the CoCo not the Multipak. VEF picture included 
X 1 OContrl : OS9 Software to control tlie PC version XIO Appliance 

Controller (req. RS-232 Pak) 
LPRINT : Directions for constructing a parallel PIA printer port. 

Includes to printer descriptors. 

MuWvttc Public Domain Disk 1 

Tetris 

GradeMaster 

Glndex 

GsortV9 

GCall.l 

Gsortc 

GShell32 

NEWPOINT 



UNIX version (non graphics) with color and sound added 
Cmdgen Creates module that executes other module(s) 
Grade tracking program for students 
Rolodex application for MultiVue 
Latest version with all bugs removed 
New, fender replacement for MultiVue Calendar 
This replaces Gsort ver.9 with version 12 to correct bugs 
Includes all of patches to update your original GShell. 
Includes a MakeSheil Installation program 
4 color replacement pointers for the STDPTRS in the 
SYS directory for use with Multivue 



Patches and Memory Modulei Public Domato Disk: 1 



CC3DISK,V1 1 

CC3GO.SSYS 

CLOCK,SSYS 

FSTGRF 

UTRAACIA 

TSEDIT 

ACIA.PAT 

DYNAPAT 

BOOT80COL 

GRFDRV2 

GSHELL24A 

GSHELL 

GSHELLPA 

GRFPATCH 

SSPAK 

GFX2PAT 

KRNL 

DEDPLUS 
WINDFIY 
MV2PAT 
PARTGEN 

CACHE 
CC3DIS 

REPAKFIX 

DMHELP 



MULTID 
SERMIDI 
SMARTWATCH 



: Allows disk 1/0 under' different formats (PC, At.ari) 

: Required when using Speech Systems Real lime clock 

: Required to access Speech Systems Real Time clock 

: Kevin Dariing's High speed patch for Levd-ll GRFDRV 

: Creates larger huffer area for faster RS-232 access 

: Pat.ch to enable TSEdit, t.o display 80 column Levd-II 

: AnotherpatchliyPeterLyalltoenlaigehuffeiarea 

: Patches Dynacalc to permit lOO column display 

: Permit blue/white 80 column text screen on boat-i^). 

: PatchesKevenDarlingspatchedGRFDRV for25Iines, 

: Patches Gshell+ version 24a for fester operation 

:'iliis is the GSHELL+ upgrade patches pack^e. 

: Enhancement patches forGSNELL+ vers. 1 ,24 or 1. 24a 

: Patches GRFDRV for 25, 27 or 28 line screens 

: OS9LeveITwoDriver&DescriptorforSpeechSoundPak 

bicludes instructions modify the PAK for Level 1 1 . 
: Patch to correct misahgninenl of the "Fill" name in 

the enhanced g6c2 (GFX2.AR) file on UtUit.y Disk 3. 
: Patch to Kemal to give it OsK (OS9-68000) compatble 

filenames. "A" "Z" "a" "z" "O" "9" "-" "$" 
: Patch forDED to auto-recongize bit Allocation map sect. 
: Patch to prevenl MuUivue menu-bar "roBover" 
: 4 IPatch files; Windlnt; CC310; CC310.oig; Gportjpc 
: Patches Burek&Buike BBFHDisk and provides new /HO A 

/HI descriptors to allow partitioning of the hard drive. 
; IPatch to CC3Disk to permit cache capabihty to 1000 sect. 
: Ipatch to CC3Disk to permit high density (1 .2/1 .4Meg) 

floppies vrtien using the older 12vdc disk controller. 
; Corrects bug in OS9pI modules that have been patched 

for l/2Meg ram systems or modified to read 68K kernel names 
: Text file explaining improvements of DeskMate3 over Desk 

Mate2. Includes patches to add linefeeds to Xmodem and 

to make DESK module to read the /DD drive instead of /DO. 

Patch to change DESK to defeult to any window instead of 

term. Also standard 6msec step rate/40 tracks and dbl side 
: Source code to modify each Deskmate application and supply 

ICONS for use with Multivue 
: Semi device driver module to provide midi output from the 

"bit-banger" port 
: Updated replacement for Spectro-Systems Smart Watch Clock 

modules 



Patches and Memroy Modules Public Domain Disk 2 

DRIVEDOOR : This is an Ipateh &at modifies the CC3Disk irq (version 2&3) for 
the Disto SO II No halt floppy controller. This patch will aBow the 
contioDer to wait until the door is closed rather than timing out too 
quicldytogetthe disk in, Also contains other patch information to 
improve drive performance by modifyirig the motoron and motoroff 



DESK3.SCR 



SIMON PATCH 



RENAME 



VEMAC 
SCFED2 



OS9P3 



Modpatch Script file to Patch Deskmate's DESK module to 

use W-resolution joystick 

One byte patch to enable Level One Simon utility to operate corrcclty 

under Levd-2 

IPatch to penTvit full path names in second descriptor. Word- 

processMS will be able to property save temp files with patch. 

Patoh to improve operation of help options in VED editor 

Kevin Dail^igs Patch to SCF system module to enhance the keyboard 

buffer 

Boot module that will PRINTERR message vfhen and ertor occurs 
CLOCK_UPDATE: Oock modules that solve the IRQ problems 
SHELLPLUS.PATCH: Text inchiding patches to correct bugs in ShelK. I 
HISPEED : Archive with instructions and IPatch files to Bruce Isted's XACIA 

driver to permit the CoCo to tdecommunicate at speeds up to 9600 baud. 
DYNCAL : Patches dynacalc to eliminate the double space line feed problem, 

also patch to cause Tandy DMP Printers to recognize Top of Page', 

plus several other similar patches to Dynacalc, Dynastar, Plug 

N Power, etc. 
BrrBANG5 : Patch to 0S9pl to change FIRQs to IRQ's. hidudes in archive, a 

textfile describmg a modification to the 4 pin serial plug and new serial 

I/O driver and new Tl & T2 descriptors. 



Progranmilng Public Domain Disk 1: 

CC2 : Lev-2 C Compiler double pass execution module 

AUB : RMA(RelocatableMacroAssemiiler)Libraryfiles 

CTUTORIAL : 1 4 Chapter text with example source codes for learning "C 
DE VPAKCUPDATE: Inslmclional text on how to apply updales to Ihe "C" 
Library fixjm from the 0S9 Development. System disk. 
CC2RAM : C Compiler execuition module for compiling 'C files in RAM 

Programminp Public Domain Disk 2: 

CUBT.I 
CLIB.l 
CGFX.I 



Kjeider "C" Library 
Kreider "C** Library 
"C" Graphics Library 
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Sli:)LIB2,C : Kreider's standard "C" Ubraiy files 

PASCAL DEFS : Pascal Library files for Level Two 

AUZIE SCULPTOR : Sculptor source codes for creating/demonstrating 

Sculptor datahuase system 
DEVSYS : User fiiendly interfece for C. Pascal, ASM & RMA Assemhlers, 

C START : Direct replacement for Microware's cslait.r LIBrary File. 

MINILINT : Utilil.y to precheck C souirce files for construct/syntax errors 

SIGMON OS-9 Level-ll Debugger (belter Ihaiu Microware's DEBUG). 

BLIST : Prints basic09 programs with pagination and breaks long hnes. 

Pro gramming PttMk Domain Disk 3 

: Graphical User Interface C library by J.Delaney A D.Hauck 
; Mouse driven fi^ont end for the microwaie® C-Compiler 
: Enhanced graphics module for Basic09 written in C 
: Corrects C-Compiler bug in which multidimension arrays are 

partitioned 

: ANSI standard C preprocessor. Replaces Micronrare's cprep 
: Replaces stock CC executive for the C Compiler. Makes rurming 

JMLSOFTs ''c_piep'' easier for ansi compiling. Seeks RAM disk 

for faster operation but will use disk if R or RO are not found. 
: Rqjlacement for the 'findstf C standard Ubrary call. It is 

ftjnctionaUy identical to the Kreider version but 63% fester. 
: Monitors C source code, reporting hne by line like LINT. 

However, CNTX detects punctuations errors. 



GuiUblO 
C^ENV 
GFX3 
CARRAY 

CPREP 
CC5 



FINDSTR 
CNTX 



Sound-Music Fublkr Domain Disk 1: 



PLAY5 
ULTIMUSE 



LYRA 

SERMIDI 



: Newest PLAY module 

: Lef s you write and edit slieet music on a graphics screen, and 
play on any MIDI-equipped synethesizer. 
: 0S9 Demonstration of Lyra (Similar to UltiMusE) 
; New /Tl descriptor that outputs bytes at tjie MIDI rate of 31,250 baud 



Sound-Mugjc PuHiic poroaJn Disk 2: 

"PLAY" FILES: 

jfltmac aye.mac hack.mac 

damnit.mac davelmac doormac 
power.mac jvulcan.mac landing,pk 



beame.mac bimbos .mac 
genqtrs.pla mrscott^ac 
Liftoff.pla disrupt.pla 



TcJecom PuiilicD«Mna(nDtskl: 

AClAMapin ; Filter to change control strii^ from a terminal into 

coiresponding arud strings. 
ACIAMapOut ; Appendage from the ACIA Driver, gets contiot of biit. Read, 

and Write and passes them thm ACIA to the physical device. 
DNLOAD : Copies irqjut from specified device to Stdout. 

UPLOAD : Capies Stdin to spedfied device. 

BBS : Ba5ic09 BuUetin Board Modules 

BIGT : Smart Tenninal with xmodem, ascii protacols 

TUBE,C : Copies charact.ers to/firom device. 

DTERM : Dumb terminal with xmodem protaca I . 

KERMfT : Download/Upload protacol between t.emuinal syst.ems 

USER : BBS Sysop utiHty to view user files, 

TELSTAR2 .3 ; Excellent smart tenninal program (40k) for leve 1 -II. 
XCOM9 : Another excellent fidl fiinction tenninal program. 

ALrrOBAUD_TSMON : Detects incoming baud rate. 
SUPERCOM : Leve 1 -li fiill fimcdon teraiinal program with xmodem 

Telecom Pufalk: Domain Disk 2: 

WIZPRO : Basic09 - OS-9 Level 2 Tenninal program 

Telecom Public Domain Disk 3: 



OSTERM208 

NEWXCOM9 

SCRIBE23 

BITBANGv.5 

MAXQWIKIO 

ADQWK30 

SUPERCOM22 

TAGEDIT 

HI_SPEED 
BFTBANGS 



Tdecommunications package. Version 2.08 Requires RS-232PAK 

Tetecomniunications packs^e. Bells and Whistles added to orig. 

OfEbne message reader and auto posting 

A device driver for the internal serial port permitting 1200 baud 

Ofifhne message reader 

OflBine message reader 

New?st version of Siqjercom tenninal program 

Used with SCRIBE (vas.4) offline reader, provides 

automatic end of mess^e tag lines. 

Text and IPatch files for SACIA to improve RS-232 performance 

Patch to OS9pl to change FlRQ's to IRQs. hidudes in archive, a 

textfile describing a modification to the 4 pin serial plug and new serial 

I/O driver and new Tl & T2 descriptors. 



UtiBtT Public Domain Disk 1: 



ARCHIVE 
MODLTHL 



RSDOS 

SDIR 

AMPUTATE 

PALETTE 

AR 

DLS 

PCDOS 

WCONFIG 

BCOLOR 

FCOLOR 

BORDER 

EATLF 

PRINTHELP 

QTIP 



Creates destination directory and copies files to new dir. 

Collection of enhanced standard OS9 utilities: mbackup, mdate, 

mdump, mfomiat, mmakdir, mmfi'ee, pmode, rep, split, unusc, 

verm, inxmode 

File transfer utility from Radio shack Dos fomiat to 0S9 

Super Directory to enhance/replace standard DIR utility 

Forces the term call of tlie cache device driver returning 

memory to the system and delete all files on the device. 

Change scree/window palette (color) on the fly 

OS9 Archiving utility (version 1 .3) 

Directory utility 

File tiransfer utility from PC format to OS9 

Window configuration utility 

Change background color: Bcolor <color> 

Change foreground color: Fcolor <color> 

Change border color: Border <color> 

Deletes Line Feeds from downloaded files 

Prints SYS/helpmsg to screen/printer 

Chsk zap ulihty (self prompting) Text or Graphics screen 



RESET 

CALL 

IPATCH 

SORTDIR 

WMODE 

CLEARD 

LABEL 

STRIP 

ZAP 

LSH 

SYSINFO 

CONVERT 

MARPATCH 

TREE 

PAK 

UTIL3 
PROC 
PMAP 
PATHS 
DDIR 
IDIR 
DIRM 
MMAP 
SMAP 
DMEM 

COPY 

DIR 

PURGE 

DASM 

DISROPT 

CUTS 

DAM 
NEWCRC 
DPOKE 
DUPEFILE 

UtilttT PubUc 



MORSE 

SDIR 

SHELL21 

SCRIPT 

ULDIR 

CRC 

HDKIT 

BOOTSPLrr 

CC2 

D 

DEMODE 

DMODE 

DIRCOPY 

PRINT 

PRINTERR 

PRINTHELP 

SEPARATE 

DIR 

DISRCAT 

DISASM 
DED 

ULDIR 

COMPARE 

RSFORMAT 

RSRENAME 

REBACK 

MAIL 

DIRLTHL 

SBACK 



: Reyboard "cold start" 

; Calls commands repeatedly. Command list with Hnes on stdin. 

: Creates a new file from an Original file and a Patchfile 

: Sorts directoiy entiles in ASCII order 

: Returns status of cument window 

: Deletes all files from directory 

; Renames the Disk Name/Label (self prompting) 

: Strip or Add Character (hne feed, carriage returns) 

: Disk zap utility. Must be in 80 colunui mode 

: Unix type Directory Utility 

; Complete status report of current windowAenninal including 

current palette colors. 
; Converts decimal to hexidecimal equivalent numbers(visa versa) 
: Created patch file for use with IPATCH 
: Directory utility. List hierchical listii^ of all directories, 

files, subdirectories, files. 
: File Archive utility 
: Merged utilities file: 

: Enhanced "PROCS" utility showing I/O of each process 
: Memory map of each process location 
: I/O path of each process 
: Device Directory 
: IRQ Directory 

: Dir-e equivalent of MDIR.. . displays correct memory blocks 
: Memory map of used and unused SR blocks 
: Memory of pages in RAM 
: Memory dump by location instead of file name 
: Updated PD version of standard Copy utility 
; Updated PD version of standard Dir utility 
: Deletes file(s) from a directory 
: Disassembler for Level-I ASM and Level-II RMA files 
: Graphics DCHECK Utility (Self Prompting) 
: Coder/Decoder for transferring binary or ascii files on 

systems that do not support error checking protacols. 

Gives a graphic display of disk sector allocation map 

Replaces the VERIFY command. Doesn't require new filename. 

"Poke" hex code to the ofifeet address of a file 

Duplicates any file on the same disk. 

Disk 2: 



Reads data from std-in and converts to Morse Code audio tones. 

Unix "LS" type 'Super Directory utibty 

OS9User Group's expanded ''shell+" module for OS9 

Script files for use with Shell+ 

Converts files and directory names to pcoper case(Up{)er/Lower) 

Turns ofif the CRC check routine in OS9pl 

Peter Lyall's Hard Chive Backup/Restore Utility 

Separates meiged modtiles into individual files 

Executive routine for microware C, Compiler on CoCoB 

Single column (non-alphabetized) directory utility 

DEviceMODE utility to change disk drive parameters 

DeviceMODE utility to change disk drive parameters 

Copies files from one directofy to another 

Formated I/O listing to printer device 

Level-Il version of miciioware*s PRINTERR. 

Utility to print help message file to screen/piinter 

Separates merged modules into individual files 

Enhanced Directory Utility with Sort and Search options. 

Directory cataloging 

utility with graprfiics overiays. 

; Disassembler of machine code files (ASM and RMA) 

: Disk ZAP utility. Must be in 80 cohimn mode. 

: Converts Directory names and files to proper Upper/Lower 
Case (Difectories=<.JPPERCASE, Files=Lowcrcase) 
CMP utility that compares 2 files (one in memory, other in ram 
"DSKINr standard 35 track RS-Dos foimat 
Renames a file on a standard 35 track RS-Dos format 
Basic09 enhancements for Peter Lyall's HDKit Utility 
Multiuser Vo^ MAIL (scan/read/post) program/utility 
Graphics enhanced Directory utility with overlay windows 
Re-write of REBACK for use with a mouse and Multivue. 



Utility PubUc Domain Disk 3: 



DOALL 

EASYEDFT 

GFX2 

INDEX 

KUTIL 

SDUMP 

SMOUSE 

SUMMARY 

SWISE 

SPEEDISK 

VDG 

SCOPY 

PARTGEN 

PS 

KFORMAT 

SMENU 

MENU 



Utility thM supplies a directory listing in p^>e format, 

designed to take advantage of shell+ wildcard features 

Change device descriptors in your OS-9 Bootfile. 

Updated GFX2 for 0S9 Level-II by Kevin Dariing and Kent Meyers 

Contains tiiree programs that create, maintain and read an 

index of disk files 

To extract/modify/install the OS-9 Kemal 

Screen dump in background task. 

Permits standard PC serial mouse usage fix>m an RS-232 port 

Utility to summarize spreadsheet data. 

Utility to produce side wise printouts from dynacalc 

Disk repack/compression utility by Brian White, version 2.1a 

Generates VDG type screen for Level-I applications. 

Single drive copy util. for copying to dissimilar formats 

Hard Drive Partitioning utility for Burke & Burke systems. 

This is a "Point & Shoot" Menuing utility/apphcation 

Disk Format utility that is self prompting. 

GShell gr^hics menuing environment/implication. 

Text windows menu utility/application 
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UttHtv PubUc Domain Disk 4: 

CCUN/JP : MS-DOS de-archiving utility (PKUNZIP) for use on OS-9 

VU : Text viewing utility—THIS IS THE BEST! 

BRUIN : A UNIX type backup/restore utility 

SCOPY : Single disk drive copy utility between disk of non- 

similar format (35 track to 40 track, etc.) 

FREE : Replacement for original. Faster, outpus in kilobytes 

and percentage. By Tim Kientde '90 

BOB VAN DER POEL UTILITIES: 

INTLEAVE 

DSETIME 

DIR 

FFIX 

PHONE 

BUST 



HDIR 

VEFSAVE 

VEEPRINT 

VEFPRINT.23 

MAtCEFILE 

CCHDISK 

DUAL DOS 

DATES 

MDUMP 



: Checks disk drive to find optimum interieave. 

: Causes system clock to be reset by DISTO hardware clock. 

: A more complete version of Super LS by Conejo Computer 

: Listing utility that eliminates TABS and CR/LF 

; Phone dialer and "auto login" to BBS's 

: Display a BASIC09 program that has been listed to a file 

with pagination and properly formats the break up of too 

long lines. 

A TREE Directory. 

Save an existing grphics screen to disk 

Print a VEF file to an Epson printer with a 640 dot mode. 

VEFPRINT for printers that print 23/216 inch Ime spacing 

Assembles VEFSAVE and VEFPRINT listed above. 

Replacement for DlSTO's hard drive adapter driver. 

Puts an RS-DOS section on an OS-9 Disk 

Calculates the day of the year given the year, month, date 

Dumps memory to tlie screen or printer 



UtiUty Fublk Domain Disk 5: 



CACHE 

DEARC 

DIFFY 

MAKDIR 

OS9ARC 

REBOOT 

TCU 

VIRUS 

WC 

WHEREIS 

ALIAS 

STEST 

ZACK SESSIONS UnLmES: 

BANNER 

SDIR 

LABEL 

CVTPIC 

PRT 

ATTR 

GRDEMO 

RSSAVE 

LABELS 

FLBACKUP 

PRSET 

SETUP 

UtlHty Pablk 



IPatch that sets the cache size and prints the cache status for each drive 

Dearchives files that have been archived by MS-DosAJnix ARC utility 

Creates multiple windows (with shells) on the same screen (OVERLAYS) 

Replacement for original Microware MAKDIR utility 

039 version 1 .0 of MS-Dos/Unix ARC utility 

Archive contains "cold" and "warm" reset 

LF <fc CR stripper and TAB to SPACE convert 

Maintains a file of specified files and their current CRC for comparison 

Counts characters, words and lines in a specified input file 

File finder utilities: Ff and WHEREIS 

Creates a file-name that will chain to a specified execution module 

Test sectors of either floppy or hard drive 



Banner printing pn^ram 

Super Directory utility to replace the stock version 

Change disk label volume name 

Converts HSCREEN2 images in DECB to VEF format in OS9 

Pnnter utility to print several files, one afber the other. 

Replacement for stock ATTR. Accepts wildcard patterns 

Creates a VEF demo boot disk for a continuous dem(mstration 

Functions tike DSAVE except ftom RSDos disk to /dO in OS9 

Address Labels and Free Format Labels print program 

Backiqj utility that uses a RAM Disk for filter copying 

Sets Tandy's DMP-106 printer font characteristics 

Sets up values for monitor and hi-res/right port during starti^) 

Disk 6: 



DISKCOPY 

DSCAN2 
SCAND 

POP V44 

FSEDIT 

COMPRESS 

ARM 

CMPFIX 

SETBFT 

HEXDEC 

MD 

MERGEMODS 



Copies files from one directory to another or fi-om one media to 

another regardless of the format. 

Scans Hard or Floppy drives to locate bad sectors 

Scans Hard or Floppy drives to locate bad sectors (Faster then 

DSC AN) 

Creates windows on the fly 

Disk Editor 

UNIXA/MS data compression utility 

Another non-authorized version of the AR Archiving utility 

Changes a CMP command output to an IPatch format file 

Used to set bits in allocation table representing bad sectors on disk 

Hexidiamal/Dedmal Conversion program that goes beyond 65000 

Color Graphics Display oiMDIR 

Provides user with a selection of files for merging that will fit into 

an 8K memory block. 



UtiUty PubOc Domain DItk 7: 

CRONC : Background task manager that wakes up every minute to check data file to 

see if it should execut a specified process/application (CRON v. 10). 

CRONTOOL : UtiUties for CRON 

SCULPT_SCRN, PAINT: Self promptiitg utility to create custom input screen for Sculptor 
database 

SS MENU : Shell+ script file that allows you to run various OS-9 Level-2 screen savers 

EASYEDIT : OS9 Boot editor. Re- writes changes to your boot disk 

WIDTH : Select 40 or 80 column screen 

JTFM : File manager. Graphic display of directories and available commands. Mark 

file(s) for processing. AU standard command proccesses available on screen 

MELT : Cute screen dissolve routine then returns screen to original state 

MORE . Text viewing utdity 

VU : Better text viewing utility 

SDUMP : Dumps screen to printer by holding down ALT-CTRL and SHIFT 

TAR , UNIX file compression utility 

STREAM : Fast Hard Drive Backup Utility. 20 Meg Drive in 2 hours. 

ARl .5b : Newest version of AR Archive utility 

JUNK : Saves deleted files to a ''JUNK" directory. (Smart Erase) 

TRXMON : TSMon, Password, l^gin, NewUser improved replacements 

MDIR4 : OSK type mdir with search and type options 

DIRECT : Simple Directory Copy utility. 

AR 1 . 5B : Newest ARchive utility (unauthorized) 



CLRMEM : Contains newer and better UN LINK and DEIN IZ utilities. 

Reports status Formats. Performs mult^>le formats and auto 

increments filename-number 
UNLZH7 : Latest version (bugs fixed) de-archiving utility 

CRON (vers. 10) : Task scheduler 

Utility Public Domalnd Disk 8: 



UNLZH_7 

LZHIO 

WEDGE_16 
MBACKUP 

VFY9 

UNARJ09 

HELP 



HELPCMDS 

COLORC 

BOOTROM 



SCFI4 

SOUKD2 

MKDIR 



UUENCODE 
RCOPY 2 



; LHArchive Utility. Tlus version corrects bugs found in earlier 

versions. Archives and de-archives. 
; LHArchive Utility. This version written by Matt Thompsoa Not 

ported in C from other sources but written in ASM specifically for the 6809. 
: This is similar to MODBUSTER. Removes merged modules from a file. 
: Backup utility that can use more memory &en the standard 

64K block without interferring with system operation. 
: Verify, Ident and Header/CRC fixit program 
: ARJ un-archive utility. 
: Replacement for original HELP command. Searches individual help 

text files in /DD/HELP directory. Can seek help files by topic and 

subtopics in subdirectories within /DD/HELP. 
: Archived collection of individual help files (75Kbytes) that 

are accessed by the above HELP executable program 
: File transfer utility between OS-9 (CoCo format) and MS-DOS. 

To be used on an MS-DOS machine. 
: Archive contains patch to the REL module (fixes bug) and a 

DECBasic prc^ram to save the kemal to DECB formatted disk 

which then is bumed into an EPROM to cause OS-9 to boot fi-om 

your floppy directly on power up. 
; Menu driven collection of usefiii utihties: CHD, DIR, VIEW, HEX 

DUMP, LOCATE STRING, WORJD COUNT, COUNT CONTROL 

CHRS,. FIX FILE, STRIP CHRS., DELETE, COPY, FSTAT, ASCII 

CHRS. DISPLAY, ASCII CONTROL CHRS. DISPLAY. 
: Adds Kevin Darling's enhanced editing capability on keyboard 

input. BUT also adds the ability for a device to be NON Shamble 
: A command to replace 'DISPLAY 77777777 to cause a longer 

sounding tone on the terminal. 
: Makdir utility that permits user to allocate number of sectors 

to use or the number of filenames. Also permits attributes to be set by 

hexidicmal numbers (7b = sewrewnr), and force lower case name instead 

of uppercase for directories. 
: Multi user CRON utibty. Used as a baclqground task to execute 

commands, fimctions or activities at specified times. 
: Decoder/Encoder of binary fiks to/from ASCII text format. 
: Front end interface for RSDOS file transfer utility to make 

for easier operation. DMODE must be available in the CMDS dir. 
: Front end menuing inter&oe for PCIX)S file transfer utility 



Word Processor Public 



DUk: 



UEMACS 

ED31 

MROFF 

SLED 

PF23 

TED 
VEMAC 



"Micro E-Macs" Unix Text Editor. Most powerfiil line editor. 

Graphics fidl screen text editor (version 31) for Level-II. 

Text formatter using Word Star DOT "." formatting commands. 

Text processor with on screen help windows. 

Print formatter. Reads imbedded control condes in text file to 

printer I/O. Includes specific printer cap.files. 

Simple text editor with auto word wrap set at 72 characters. 

Patch to improve operation of help options in VED editor 




Terry 
Laraway's 

CoCo 
Etcetem 

Parts 

Hardware 

Hard to find items 



Hitachi 6309 chip & socket $ 1 2 

Kel Am custom 'Y' Cables (Call) 

5 12K Ram Chips/Kits (Call) 

2400 Baud hayes compatible ext. modems $40 

Serial to Parallel Interface with 64K buffer $50 

Phone (206) 692-5374 
41 N.W. Doncee Drive, Bremerton, WA 98310 
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Corrections 

In the 1993 February issue of the Newsletter in which I 
described a hardware project using a 68B21 PIA chip "piggy- 
backed" on top of the original 68B21 on the CoCo-3's 
motherboard to provide for a Parallel Printer Port. Much to 
my cmbarrasement, it didn't work properly on a CoCo-3. In 
fact it caused some computers to lock up. Other reports 
included false characters printing to the screen in response to 
the keyboard, etc. The solution to the problem began when 
Gerry McCleary mentioned in passing at the PNW 
CoCoFEST that the CoCo-3 PIA should be toggled on pin 22 
instead of pin 24. After pouring over the CoCo-3 and CoCo-1 
& 2 schematics for comparison, the light bulb finally 
flickered. Turns out that Tandy, in it's infinite wisdom, chose 
to do things quite differently when it came to "enabling" the 
PIA chips. There was also some problems with the software 
which had not been tested out on a CoCo-3 by the author, 

1 drafted the help of Mike Pleas from the Bellingham 
OS-9 Users Forum to assist me in altering both the hardware 
and the software to make this project work. It turned out to be 
very simple, and I learned a great deal more about assembly 
code. 

The corrected schematic and cable connection table are 
shown below and to the right. The software patch turned out 
to be very simple. Use dEd, modpatch or debug to correct the 
"extended address" as follows: 

Offset Old New 
SOOOE $00 $07 
$0010 $24 $28 



Review the wiring diagram carefully as it will result in a 
different set of instructions then what was printed in the 
February article since pin 22 of both PIA*s are used instead of 
pin 24. Note especially that pin 22 on the original PIA is 
pulled up fi*om the motherboard and that the output of the 
7404 chip is now applied to the original PIA instead of the 
new one. Hopefully an upgrade to this project will be coming 
from Mike Pleas to completely eliminate the need for the 7404 
chip. 

A complete set of proper instructions along with a disk 
containing the assembled software is available for $1. Mail 
your order to the OS-9 Newsletter, 3404 Illinois Lane, 
Bellingham, WA 98226 
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8 
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32 
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SPECIAL NOTE: A correction to the Hard Drive interface 
posted in the '92 May issue will be included in next months 

newsletter 



Signal Qnd 

Busy 
Paper End 



P 
A 
R 
A. 
L 
L 
E 
L 

P 
O 
R 

T 




to 
IC2 
pin7 



to 
PIA 
pin 1 



to 

PIA 
pin 20 



to 

old 
PIA 
pin 22 



Strobe, 





L. ' 




SN7404 


45V 




3* 


ov 


1 14 

13 

3 12 

11 
5 

9 
7 






^ ^ 


3 "* 
3 A 


:=:j ] 

r^ 




3* 




(OND) 













Figure 1 



10 



OS-9 Newsletter 



August 1993 




Club Activities Report 

Bellingham 0S9 Users Group - Longview/Kelso CoCo Club 
Mt Rainier CoCo Club - Port O'CoCo Club - Seattle 68xxx Mug 



THE W^ORLP^S FIRST SOLPERFEST 

What happens when you put a bunch of grown children together with their favorite buildable toy in a location of endless junk 
food with construction experts? Well, you have a SolderFest, of course! The first event of its kind was in Port Orchard August 
19th. Port O' CoCo underwrote the event by covering the expenses of break open, cut & solder and rewire expert Rodger 
Alexander. He was flanked by Terry Laraway and Gene Elliott, both of whom have extensive experience in upgrading and 
adaptations of the CoCo in one form or another. 

The word went out quickly, actually the whole thing was arranged just in a matter of days. Even with that, the response 
was all positive and strong. Rodger arrived from Bellingham early afternoon and others showed up as their interest and project 
demands required. Each person was doing something different. One was building a tower from scratch. Another was 
integrating a modem and printer buffer into his tower. Some were their for just a few hours and others took Ml advantage of 
Stock Market Foods being open 24 hours. The one to finally hang th^ dog was Buzz Jones who left after 1 a.m! As one person 
said there was more accomplished in this one event than most of our meetings. I don't disagree and hope that the experience 
helps the monthly meetings as well as suggests that we have another SolderFest in a few months. What about January, folks? 

==Donald Zimmennan== 



Bellingham Users Forum 

Our August meeting dealt with the successfiil completion of 
the Parallel Port. Rodger found more complete references on 
the Centrex Parallel Pin-Outs. This resulted in several 
changes on the port wiring to the 68B21 chip. Mike Pleas 
was working on the software end discovered with some 
comparative examinations of other SCF descriptors that the 
accepted memory blocks were set for block 7 while our somce 
code was set up for block one. We also confirmed that it was 
necessary to toggle pin 22 instead of pin 24 on the PIA chip to 
enable it properly so we used Address line 3 accomplish this 
and changed the extended address in the descriptor to FF28 
(Hex). 

We ran several test and even the new error code #199 - 
"Out of Paper" responded correctly. What was kind of fun 
was to run two printers at once. One printer on the serial port 
(/P) and the other printer on the new parallel port (/Pi). Very 
cool! Well be demonstrating it at the Seattle 68xxxMUG 
meeting in September. 

We also had a second meeting on Saturday, August 28, to 
address the problems with the hard drive interface. 
Apparently we were terribly at fault in the correction posted in 
August'92 issue to the original interface article. We had 
thought that Pat Plueard set up his interface to the wrong 
address. Turns out we were wrong because we were using the 
PC-AT (Intel's 68286/68386/68486) hard drive address: 3F0 
(Hex). Pleuard's circuh was addressed to 320 (Hex), which 

was correct, BUT there were several "little" things omitted 

such as the physical tie downs of the higher PC Addresses 16- 
19. We have also discovered that Pat was not taking 



advantage of the bmlt in ROM address and the data buffers on 
the PC controller cards. AND when comparing with Burke & 
Burke's XT interface we found that Chris Burke was 
addressing to CBF20 (Hex), not the hard drive I/O address. 
Hmmmmmm???????? More to follow. 

=Rodger Alexander== 



Fort 0-CoCo Club 

The August meeting of Port O'CoCo was a split event. It took 
place over two days - almost three. But we are getting ahead 
of our story 

First there was the honoring of those who had birthdays in 
August Mark King, Mark Kulien, Bob Vail and Terry 
Laraway all received a pass to the theater and a sample of 
Gold- Wipes (for cleaning, lubricating & protecting Gold & 
other metal contacts on printed circuit boards). 

On the down side we have two people on the sick list. 
Phyllis Armstrong is coping with back difficulties. Jim 
Coleman was our speaker a couple months ago. He's the 
sysop of NASA MLP BBS (206-871-3965). He is a strong 
supporter of BBS' as a place of education and information. As 
the name reveals, his BBS is heavy into science information. 
He recently was in a very serious auto/bike accident. There 
were a couple days in which his life was in question. Now he 
is slowly recouping and will be able to walk again in 6-9 
month. In the meantime, use and support of his BBS is 
appreciated. 

A recent development for PNW CoCoFEST is a vote taken 
by the board of the Computer Bank Charity. The board voted 
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to be a co-sponsor of PNW CoCoFEST 
IV, June 25, 1994. We are in the process 
of discussing further co-sponsorship with 
a large computer organization in Kitsap 
County, the Kitsap Computing Seniors 
with a well established membership of 
about 400. Corporate sponsorship is also 
part of the goal of the next couple 
months. 

The group at tonight's meeting voted 
to underwrite the travel expenses of 
bring Rodger Alexander to Port 
Orchard on August 19th for a "Solder 
Fest." This is a hands-on event at which 
those building their system bring in all 
the pieces, chips, components and 
Rodger and those in attendance assist 
you in getting your system enhanced and 
running 

A second authorization of funds was 
to ask AM Computer Swap Meets if they 
would accept a fee of $100 for both the 
September 11th (Kent) and November 
13th (Kitsap) Swap Meets. The normal 
price is $125 each. [We just received 
word 8/24 that they accepted our offer] 
Our goal is to continue to provide 
exposure and support for those using the 
CoCo system as well as letting those 
wanting to sell their systems where they 
can get a better price. 

Our last financial discussion 
concerned the value of a newsletter for 
the group. Terry discussed, showed 
recent copies and handed out some 
samples of the various publications 
related to CoCo/OS-9. In case you aren't 
aware of them, they are: Uptime, CoCo 
- 7, 2, 5, Australian OS-9 Newsletter, 
The "International OS-9 Under- 
ground, 68* Micros (fust started this 
month). No Name, Adventure Survivor, 
and our area^s awn great publication 
OS-9 Newsletter. The latter devotes a 
great deal of space each month to club 
activities. So there didn't seem to be 
much need in another pubUcation, But 
there was support for a reminder post 
card and request for equipment for sale 
for those no longer interested in the 
CoCo. That process will begin with the 
September meeting. 

Bill Barker brought some details 
about moving the meeting to another 
location. His suggestion is the Salvation 
Army building in Bremerton. The 
Army*s only request is that someone 



from the club produce graphics 
material and maybe a simple newsletter 
when the organization needs it in 
exchange for use of the space. 
Whatever the outcome of this 
discussion we just need to plan well in 
advance to alert everyone of the new 
location. We lost of lot of our 
momentum a few years back when we 
had to leave Kitsap Bank for our 
current meeting location at Stock 
Market Foods. 

The next meeting is September 
20th, 7 p.m. 

==Donald Zimmerman== 

Seattle 68xxx MUS 

The August meeting began with 
"commercial" presentations given by 
Rodger Alexander and Donald 
Zimmerman. Rodger passed out a 
flyer describing all of the current 
products available from the 
BelUngham OS-9 Users Forum, 
These included the **HOW TO Video 
Tape Library", the PDS Database 
(which was actually written by 
members of the 68xxxMUG group last 
year), and the OS-9 Level Two and the 
Color Computer Tutorial Donald had 
a few more "CoCo FEST III T-Shirts" 
and "CoCo FEST Mugs" left and was 
letting them go at a special club 
discoimt. Jeff Brittain bought both a 
Mug and T-shirt for $15. 

The official portion of the meeting 
started off with a presentation by 
Rodger on "The Final Fix" which was 
also the feature article in the July 
Newsletter. This was a hardware 
project that used a 7402 NOR gate to 
correct a probable error by Tandy in the 
construction of the C^Co-3. (See page 
1 of the OS'9 Newsletter, "Correct All 
Fix for the CoCo-3". Everyone at the 
meeting came up with schematics in 
hand and looked at how simple the 
project actually is to do. According to 
the article by Charles Bundy IV, the 
fix corrected "sparklies, the boot order 
bug problem, and a particular problem 
the author was having with his Disto 
No-Halt Controller and the Burke & 
Burke XT-RTC Hard Drive Interface. 



While Rodger was cleaning up, 
Scott Honaker entertained us with 
ASCII srnilies. These are typed 
charaaers placed on the screen to create 
happy faces :-) , winks ;-) , or frowns. 
:-( , You can also use a combination of 
characters to "draw" animals or fancy 
banners. Besides the cute ASCII smilies, 
there are also some accepted 
abbreviations that are used on E-Mail 
and Bulletin Boards. Several examples 
are: 

BTW - By the Way, 

IMHO = In My Humble Opinion, 

TTYL = Talk To You Later 
It was very humorous and entertaining. 
Keep it up Scott! We all need to laugh 
more. 

Randy Kirschenmann gave a 
presentation on C assembly pointers and 
address characters. It was way o\^er my 
head but I'm sure some of those in 
attendance got a great deal from Randy's 
presentation. 

Randy and John Schliep gave a 
short presentation on the features of the 
latest version of Shells. This is version 
number 2.2 and has an added "history" 
feature similar to UNIX systems. This is 
an expanded keyboard buffer, similar to 
what we have on the CoCo when we type 
CTRL-A (or Shift-Right Arrow with 
K. Darling's SCFed), except not only 
can you recall the last typed in entry, you 
can now select from the last page of 
entries. WOW! Unfortunately we did 
not have time to actually see a demo of 
ShellHist.AK However, this is a public 
domain program and is posted on Chris 
Johnson's Tacoma BBS and Dennis 
Mott*s Data Warehouse. 

=Bait)ara Alexandei= 



rnCn Hardware 

FOR SALE 

ST-277R 65Meg Hard DriveSlOO 
ST-225 20Meg Hard Drive $50 
Deluxe RS-232 PAK $25 

PBJ 6-Slot MultiPak $50 



Call 1-206-734-5806 



Announcing 



4th Annual 
Atlanta CoCofest 



Holiday Inn, Northlake 



October 2 & 3, 1993 



Show Hours: 

Sat. Oct 2 10:00 AM - 5:00 PM 
Sun. Oct 3 10:00 AM - 3:00 PM 

Vendor setup: 

Fri. Oct I 6:00 PM -11:00 PM 
Sat. Oct 2 8:30 AM - 9:45 AM 

Admission: $5.00, (Whole Show) 

ResenHitions: 

Holiday Inn, Northlake. GA 
(800)-465-4329 or (404)-938-1026 

Sponsored by: 

Atlanta Computer Society 

PO Bo.x 80694 
Atlant^. GA 30366 
BB$:(404)-636-299l ' 
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